DioDocs for Excel
DioDocs for Excel
テーマと色
機能 > テーマと色

テーマと色は、ワークブックの全体的な外観を向上させるのに役立ちます。ワークブックの外観は、可読性、視認性、作業効率などの向上に大きく貢献します。DioDocs for Excelは、組み込みテーマやカスタムテーマ、さまざまな色指定をサポートしています。詳細は、以下のセクションをご覧ください。

テーマ

DioDocs for Excelでは、Workbook クラスと IWorkbook インタフェースの Theme プロパティを使用して、ワークブックにテーマを設定することが可能です。 Theme プロパティと Themes クラスを四予数ることで、ワークブックの現在のテーマも変更することも可能です。ワークブックの標準テーマは、Office 標準テーマです。

さらに、DioDocs for Excelでは、Theme クラスを使用することであなたの好みや要望にあったカスタムテーマを作成でき、それをワークブックに適用することが可能です。

テーマを変更すると、テーマフォント、テーマ色、セル範囲、チャートタイトルなどを含むあらゆる領域が影響を受けます。例えば、ワークブックに組み込みテーマやカスタムテーマを適用した場合、変更されたテーマに従って、フォントだけでなく、範囲の色なども変更される場合があります。

組み込みテーマを設定する

組み込みテーマを適用する方法については、次のサンプルコードを参照してください。

C#
コードのコピー
// ワークブックのテーマをBerlinに変更します。
worksheet.Range["E10"].Value = "Test";
worksheet.Range["E10"].Font.ThemeColor = ThemeColor.Accent6;
worksheet.Range["E10"].Interior.ThemeColor = ThemeColor.Accent5;
workbook.Theme = Themes.Berlin;

カスタムテーマを設定する

カスタムテーマを追加してワークブックに適用する方法については、次のサンプルコードを参照してください。

C#
コードのコピー
            
// カスタムテーマを追加します

Theme theme = new Theme("testtheme");   // パラメータが与えられていない場合、基本テーマはOfficeテーマです

theme.ThemeColorScheme[ThemeColor.Light1].RGB = Color.AntiqueWhite;
theme.ThemeColorScheme[ThemeColor.Accent1].RGB = Color.AliceBlue;
theme.ThemeFontScheme.Major[FontLanguageIndex.Latin].Name = "Buxton Sketch";
theme.ThemeFontScheme.Minor[FontLanguageIndex.Latin].Name = "Segoe UI";
workbook.Theme = theme;

// テーマを適用します
worksheet.Range["E10"].Value = "CustomTest";
worksheet.Range["E10"].Font.ThemeColor = ThemeColor.Light1;
worksheet.Range["E10"].Interior.ThemeColor = ThemeColor.Accent1;

DioDocs for Excel では、テーマカラー、標準カラー、カスタムカラーを使用することで、セルの背景や罫線、タブなどの色を設定することができます。ColorUtilities クラスの StringToColor メソッドやThemeColor プロパティ、ThemeColor 列挙体などを使用することで、これらの色を設定することが可能です。

ThemeColor プロパティは、ThemeColor 列挙体を使用して、組み込みのテーマカラーを設定するものです。 一方で ColorUtilitiesクラスの StringToColor メソッドは、さまざまな色指定文字列を使用して、標準カラーやカスタムカラーを設定するものです。色指定文字列としては、以下のような形式をサポートします。

形式 設定する値・フォーマット
カラー名 (定義済みの標準カラー名) red、blue、yellow、violet
RGB形式 rgb(r,g,b) "rgb(255,0,0)" …赤の場合
RGBA形式 rgba(r,g,b,a) "rgba(255,0,0,0.5)" …赤(50% 透過)の場合
HEX形式 #RGB または #RRGGBB "#F00" または "#FF0000" …赤の場合
HEX形式(透過あり) #RGBA または #RRGGBBAA "#F00C" または "#FF0000CC" …赤(90%透過)の場合

テーマカラーを設定する

セルの背景色と罫線色にテーマカラーを設定する方法については、次のサンプルコードを参照してください。

C#
コードのコピー
// セルの背景色・罫線色にテーマカラーを設定します
worksheet.Range["D2"].Interior.ThemeColor = ThemeColor.Accent1;
worksheet.Range["D2"].Borders.ThemeColor = ThemeColor.Accent2;

標準カラーを設定する

セルの背景色と罫線色に標準カラーを設定する方法については、次のサンプルコードを参照してください。

C#
コードのコピー
// Set interior and border color to standard color.
worksheet.Range["B4:D6"].Interior.Color = ColorUtilities.StringToColor("yellow");
worksheet.Range["C4:D6"].Borders.Color = ColorUtilities.StringToColor("black");

カスタムカラーを設定する

セルの背景色と罫線色にカスタムカラーをRGB形式とHEX形式で設定する方法については、次のサンプルコードを参照してください。

C#
コードのコピー
// セルの背景色・罫線色にカスタムカラーを設定します
worksheet.Range["B7:B18"].Interior.Color = ColorUtilities.StringToColor("rgb(211,211,211)");
worksheet.Range["B7:D18"].Borders.Color = ColorUtilities.StringToColor("#000000");